[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 SCRTEXT(IEXP1,IEXP2,IEXP3,BEXP) (STRING)

 Function
  Get text and attribute information directly from BBS screen memory.

 Syntax
  SCRTEXT(x,y,len,color)

   x     = An integer expression with the x coordinate (column) from which
           to read screen memory.
   y     = An integer expression with the y coordinate (row) from which to
           read screen memory.
   len   = An integer expression with the length, in columns, of the string
           to read from screen memory.
   color = A boolean expression with TRUE if color information should be
           included, FALSE otherwise.

 Return Type & Value
  STRING
  Returns the specified region of screen memory.

 Remarks
  This function is useful for temporarily saving a portion of screen
  memory, with or without color information.  If the color parameter is
  set to TRUE color information will be included in the form of @X codes
  embedded in the text.  Note that the maximum length of a string is 256
  characters; however, a row of 80 characters could be as long as 400
  characters (4 bytes for the @X code and 1 byte for the character itself).
  You should generally limit yourself to a length of 51 characters or less
  if you want to include color information unless you are certain that
  attribute changes will not exceed the 256 character string limit.

 Examples
  ' scroll the screen to the left 5 columns and down 3 rows
  INTEGER r
  STRING  s
  FOR r = 20 TO 1 STEP -1
    LET s = SCRTEXT(6,r,75,TRUE)
    ANSIPOS 1,r+3
    CLREOL
    PRINT s
  NEXT
  FOR r = 1 TO 3
    ANSIPOS 1,r
    CLREOL
  NEXT

See Also:
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson